home *** CD-ROM | disk | FTP | other *** search
/ ...taking it to the Macs! / ...taking it to the Macs!.iso / Extras / ActiveX Mac SDK / ActiveX SDK / Headers / DVOBJ.H < prev    next >
Encoding:
C/C++ Source or Header  |  1996-07-15  |  17.0 KB  |  517 lines  |  [TEXT/????]
  1. /*****************************************************************************\
  2. *                                                                             *
  3. * dvobj.h -        Data/View object definitions                                  *
  4. *                                                                             *
  5. *               OLE Version 2.0                                               *
  6. *                                                                             *
  7. *               Copyright (c) 1992-1994, Microsoft Corp. All rights reserved. *
  8. *                                                                             *
  9. \*****************************************************************************/
  10.  
  11. #if !defined( __DVOBJ__ ) && !defined( _DVOBJ_H_ )
  12. #define __DVOBJ__
  13. #define _DVOBJ_H_
  14.  
  15. /****** DV value types ******************************************************/
  16.  
  17. //      forward type declarations
  18. #if defined(__cplusplus)
  19. interface IStorage;
  20. interface IStream;
  21. interface IAdviseSink;
  22. interface IMoniker;
  23. #else 
  24. //typedef interface IStorage IStorage;
  25. //typedef interface IStream IStream;
  26. //typedef interface IAdviseSink IAdviseSink;
  27. //typedef interface IMoniker IMoniker;
  28. #endif
  29.  
  30. typedef         interface IStorage * LPSTORAGE, ** LPLPSTORAGE;
  31. typedef         interface IAdviseSink * LPADVISESINK, ** LPLPADVISESINK;
  32. typedef         interface IMoniker * LPMONIKER, ** LPLPMONIKER;
  33.  
  34.  
  35. // Data/View aspect; specifies the desired aspect of the object when 
  36. // drawing or getting data.
  37. typedef enum tagDVASPECT
  38. {
  39.     DVASPECT_CONTENT = 1,
  40.     DVASPECT_THUMBNAIL = 2,
  41.     DVASPECT_ICON = 4,
  42.     DVASPECT_DOCPRINT = 8
  43.     ,DVASPECT_FORCELONG    =    2147483647
  44. } DVASPECT;
  45.  
  46.  
  47. // target device flags
  48. typedef enum tagTDFLAGS
  49. {
  50.     TD_PRINTER = 1,             // if set, td describes a printer
  51.     TD_POSTSCRIPT = 2,        // if set, td has postscript
  52.     TD_GX = 4                // if set, td has GX
  53.     ,TD_FORCELONG    =    2147483647
  54. } TDFLAGS;
  55.  
  56. // Data/View target device; determines the device for drawing or getting data
  57. typedef struct FARSTRUCT tagDVTARGETDEVICE
  58. {
  59.     long    tdSize;
  60.     // Windows definition
  61.     unsigned short tdDriverNameOffset;
  62.     unsigned short tdDeviceNameOffset;
  63.     unsigned short tdPortNameOffset;
  64.     unsigned short tdExtDevmodeOffset;
  65.     unsigned char  tdWinData[1];
  66.     unsigned char     byAlign;
  67.  
  68.     // MAC Definition.
  69.     long    dwSizeX;    // max length in pixels
  70.     long    dwSizeY;    //
  71.     short     wDpiX;        // dots per inch x
  72.     short    wDpiY;        // dots per inch y
  73.     short    wColorDepth;// in color bits (eg 8 == 256 colors)
  74.     short    wFlags;        // printer/screen,.i postscript, gx etc.
  75.     short    wMisc;        // offset to app specific data or NULL (usually null)
  76.     unsigned char tdData[1];
  77. } DVTARGETDEVICE, *LPDVTARGETDEVICE;
  78.  
  79.  
  80. // Format, etc.; completely specifices the kind of data desired, including tymed
  81. typedef struct FARSTRUCT tagFORMATETC
  82. {
  83.     unsigned long          cfFormat;
  84.     DVTARGETDEVICE * ptd;
  85.     unsigned long               dwAspect;
  86.     long                lindex;
  87.     unsigned long               tymed;
  88. } FORMATETC, * LPFORMATETC;
  89.  
  90.  
  91. // TYpes of storage MEDiums; determines how data is stored or passed around
  92. typedef enum tagTYMED
  93. {
  94.     TYMED_HGLOBAL = 1,
  95.     TYMED_FILE = 2,
  96.     TYMED_ISTREAM = 4,
  97.     TYMED_ISTORAGE = 8,
  98.     TYMED_GDI = 16,
  99.     TYMED_MFPICT = 32,
  100.     TYMED_PICT = 32,
  101.     TYMED_FSP    = 64,
  102.     TYMED_NULL = 0
  103.     ,TYMED_FORCELONG    =    2147483647
  104. } TYMED;
  105.  
  106.  
  107. // DATA format DIRection
  108. typedef enum tagDATADIR
  109. {
  110.     DATADIR_GET = 1,
  111.     DATADIR_SET = 2
  112.     ,DATADIR_FORCELONG    =    2147483647
  113. } DATADIR;
  114.  
  115.  
  116. // SToraGe MEDIUM; a block of data on a particular medium 
  117. typedef struct FARSTRUCT tagSTGMEDIUM
  118. {
  119.     unsigned long   tymed;
  120.     union
  121.     {
  122.         Handle  hGlobal;
  123.         char *   lpszFileName;
  124.         LPSTREAM pstm;
  125.         LPSTORAGE pstg;
  126.         FSSpec *pFSSpec;
  127.     }
  128. #ifdef NONAMELESSUNION
  129.     u       // add a tag when name less unions not supported
  130. #endif
  131. #if !defined(__cplusplus) && !defined(_MSC_VER)
  132.     u        // add a tag for Mac
  133. #endif
  134.     ;
  135.     IUnknown * pUnkForRelease;
  136. } STGMEDIUM, * LPSTGMEDIUM;
  137.  
  138.  
  139. // Advise Flags
  140. typedef enum tagADVF
  141. {
  142.     ADVF_NODATA = 1,
  143.     ADVF_PRIMEFIRST = 2,
  144.     ADVF_ONLYONCE = 4,
  145.     ADVF_DATAONSTOP = 64,
  146.     ADVFCACHE_NOHANDLER = 8,
  147.     ADVFCACHE_FORCEBUILTIN = 16,
  148.     ADVFCACHE_ONSAVE = 32
  149.     ,ADVF_FORCELONG    =    2147483647
  150. } ADVF;
  151.  
  152.  
  153. // Stats for data; used by several enumerations and by at least one 
  154. // implementation of IDataAdviseHolder; if a field is not used, it
  155. // will be NULL.
  156. typedef struct FARSTRUCT tagSTATDATA
  157. {                                   // field used by:
  158.     FORMATETC formatetc;            // EnumAdvise, EnumData (cache), EnumFormats
  159.     unsigned long advf;                     // EnumAdvise, EnumData (cache)
  160.     LPADVISESINK pAdvSink;      // EnumAdvise
  161.     unsigned long dwConnection;             // EnumAdvise
  162. } STATDATA;
  163.     
  164. typedef  STATDATA * LPSTATDATA;
  165.  
  166.  
  167.  
  168. /****** DV Interfaces ***************************************************/
  169.  
  170.  
  171. #undef  INTERFACE
  172. #define INTERFACE   IEnumFORMATETC
  173.  
  174. DECLARE_INTERFACE_(IEnumFORMATETC, IUnknown)
  175. {
  176.     BEGIN_INTERFACE
  177.     // *** IUnknown methods ***
  178.     STDMETHOD(QueryInterface) (THIS_ REFIID riid, void * * ppv) PURE;
  179.     STDMETHOD_(unsigned long,AddRef) (THIS)  PURE;
  180.     STDMETHOD_(unsigned long,Release) (THIS) PURE;
  181.  
  182.     // *** IEnumFORMATETC methods ***
  183.     STDMETHOD(Next) (THIS_ unsigned long celt, FORMATETC  * rgelt, unsigned long * pceltFetched) PURE;
  184.     STDMETHOD(Skip) (THIS_ unsigned long celt) PURE;
  185.     STDMETHOD(Reset) (THIS) PURE;
  186.     STDMETHOD(Clone) (THIS_ IEnumFORMATETC * * ppenum) PURE;
  187. };
  188. typedef        IEnumFORMATETC * LPENUMFORMATETC, ** LPLPENUMFORMATETC;
  189.  
  190.  
  191. #undef  INTERFACE
  192. #define INTERFACE   IEnumSTATDATA
  193.  
  194. DECLARE_INTERFACE_(IEnumSTATDATA, IUnknown)
  195. {
  196.     BEGIN_INTERFACE
  197.     // *** IUnknown methods ***
  198.     STDMETHOD(QueryInterface) (THIS_ REFIID riid, void * * ppv) PURE;
  199.     STDMETHOD_(unsigned long, AddRef) (THIS)  PURE;
  200.     STDMETHOD_(unsigned long, Release) (THIS) PURE;
  201.  
  202.     // *** IEnumSTATDATA methods ***
  203.     STDMETHOD(Next) (THIS_ unsigned long celt, STATDATA  * rgelt, unsigned long * pceltFetched) PURE;
  204.     STDMETHOD(Skip) (THIS_ unsigned long celt) PURE;
  205.     STDMETHOD(Reset) (THIS) PURE;
  206.     STDMETHOD(Clone) (THIS_ IEnumSTATDATA * * ppenum) PURE;
  207. };
  208. typedef        IEnumSTATDATA * LPENUMSTATDATA, ** LPLPENUMSTATDATA;
  209.  
  210.  
  211.  
  212. #undef  INTERFACE
  213. #define INTERFACE   IDataObject
  214.  
  215. #define DATA_E_FORMATETC        DV_E_FORMATETC
  216. #define DATA_S_SAMEFORMATETC    (DATA_S_FIRST + 0)
  217.  
  218. DECLARE_INTERFACE_(IDataObject, IUnknown)
  219. { 
  220.     BEGIN_INTERFACE
  221.     // *** IUnknown methods ***
  222.     STDMETHOD(QueryInterface) (THIS_ REFIID riid, void * * ppvObj) PURE;
  223.     STDMETHOD_(unsigned long,AddRef) (THIS)  PURE;
  224.     STDMETHOD_(unsigned long, Release) (THIS) PURE;
  225.  
  226.     // *** IDataObject methods ***
  227.     STDMETHOD(GetData) (THIS_ LPFORMATETC pformatetcIn,
  228.                             LPSTGMEDIUM pmedium ) PURE;
  229.     STDMETHOD(GetDataHere) (THIS_ LPFORMATETC pformatetc,
  230.                             LPSTGMEDIUM pmedium ) PURE;
  231.     STDMETHOD(QueryGetData) (THIS_ LPFORMATETC pformatetc ) PURE;
  232.     STDMETHOD(GetCanonicalFormatEtc) (THIS_ LPFORMATETC pformatetc,
  233.                             LPFORMATETC pformatetcOut) PURE;
  234.     STDMETHOD(SetData) (THIS_ LPFORMATETC pformatetc, STGMEDIUM  * pmedium,
  235.                             unsigned long fRelease) PURE;
  236.     STDMETHOD(EnumFormatEtc) (THIS_ unsigned long dwDirection,
  237.                             LPLPENUMFORMATETC ppenumFormatEtc) PURE;
  238.  
  239.     STDMETHOD(DAdvise) (THIS_ FORMATETC * pFormatetc, unsigned long advf, 
  240.                     LPADVISESINK pAdvSink, unsigned long * pdwConnection) PURE;
  241.     STDMETHOD(DUnadvise) (THIS_ unsigned long dwConnection) PURE;
  242.     STDMETHOD(EnumDAdvise) (THIS_ LPLPENUMSTATDATA ppenumAdvise) PURE;
  243. };                 
  244. typedef      IDataObject * LPDATAOBJECT, ** LPLPDATAOBJECT;
  245.  
  246.  
  247.  
  248. #undef  INTERFACE
  249. #define INTERFACE   IViewObject
  250.  
  251. #define VIEW_E_DRAW         (VIEW_E_FIRST)
  252. #define E_DRAW              VIEW_E_DRAW
  253.  
  254. #define VIEW_S_ALREADY_FROZEN   (VIEW_S_FIRST)
  255.  
  256. DECLARE_INTERFACE_(IViewObject, IUnknown)
  257. { 
  258.     BEGIN_INTERFACE
  259.     // *** IUnknown methods ***
  260.     STDMETHOD(QueryInterface) (THIS_ REFIID riid, void * * ppvObj) PURE;
  261.     STDMETHOD_(unsigned long,AddRef) (THIS)  PURE;
  262.     STDMETHOD_(unsigned long,Release) (THIS) PURE;
  263.  
  264.     // *** IViewObject methods ***
  265.     STDMETHOD(Draw) (THIS_ unsigned long dwDrawAspect, long lindex,
  266.                     void * pvAspect, DVTARGETDEVICE  * ptd,
  267.                     GrafPtr pGrafTargetDev,
  268.                     GrafPtr pGrafDraw, 
  269.                     LPCRECTL lprcBounds, 
  270.                     LPCRECTL lprcWBounds,
  271.                     void *, 
  272.                     unsigned long dwContinue) PURE;
  273.  
  274.     STDMETHOD(GetColorSet) (THIS_ unsigned long dwDrawAspect, long lindex,
  275.                     void * pvAspect, DVTARGETDEVICE  * ptd,
  276.                     GrafPtr pGrafTargetDev,
  277.                     void * * ppColorSet) PURE;
  278.                     
  279.     STDMETHOD(Freeze)(THIS_ unsigned long dwDrawAspect, long lindex, 
  280.                     void * pvAspect,
  281.                     unsigned long * pdwFreeze) PURE;
  282.     STDMETHOD(Unfreeze) (THIS_ unsigned long dwFreeze) PURE;
  283.     STDMETHOD(SetAdvise) (THIS_ unsigned long aspects, unsigned long advf, 
  284.                     LPADVISESINK pAdvSink) PURE;
  285.     STDMETHOD(GetAdvise) (THIS_ unsigned long * pAspects, unsigned long * pAdvf, 
  286.                     LPLPADVISESINK ppAdvSink) PURE;
  287. };
  288. typedef      IViewObject * LPVIEWOBJECT, ** LPLPVIEWOBJECT;
  289.  
  290.  
  291. #undef  INTERFACE
  292. #define INTERFACE   IViewObject2
  293.  
  294. DECLARE_INTERFACE_(IViewObject2, IViewObject)
  295. { 
  296.     BEGIN_INTERFACE
  297.     // *** IUnknown methods ***
  298.     STDMETHOD(QueryInterface) (THIS_ REFIID riid, void * * ppvObj) PURE;
  299.     STDMETHOD_(unsigned long,AddRef) (THIS)  PURE;
  300.     STDMETHOD_(unsigned long,Release) (THIS) PURE;
  301.  
  302.     // *** IViewObject methods ***
  303.     STDMETHOD(Draw) (THIS_ unsigned long dwDrawAspect, long lindex,
  304.                     void * pvAspect, DVTARGETDEVICE  * ptd,
  305.                     GrafPtr pGrafTargetDev,
  306.                     GrafPtr pGrafDraw, 
  307.                     LPCRECTL lprcBounds, 
  308.                     LPCRECTL lprcWBounds,
  309.                     void *, 
  310.                     unsigned long dwContinue) PURE;
  311.  
  312.     STDMETHOD(GetColorSet) (THIS_ unsigned long dwDrawAspect, long lindex,
  313.                     void * pvAspect, DVTARGETDEVICE  * ptd,
  314.                     GrafPtr pGrafTargetDev,
  315.                     void * * ppColorSet) PURE;
  316.                     
  317.     STDMETHOD(Freeze)(THIS_ unsigned long dwDrawAspect, long lindex, 
  318.                     void * pvAspect,
  319.                     unsigned long * pdwFreeze) PURE;
  320.     STDMETHOD(Unfreeze) (THIS_ unsigned long dwFreeze) PURE;
  321.     STDMETHOD(SetAdvise) (THIS_ unsigned long aspects, unsigned long advf, 
  322.                     LPADVISESINK pAdvSink) PURE;
  323.     STDMETHOD(GetAdvise) (THIS_ unsigned long * pAspects, unsigned long * pAdvf, 
  324.                     LPLPADVISESINK ppAdvSink) PURE;
  325.                     
  326.     // *** IViewObject2 methods ***
  327.     STDMETHOD(GetExtent) (THIS_ unsigned long dwDrawAspect, long lindex,
  328.                     DVTARGETDEVICE *ptd, LPSIZEL lpsizel) PURE;
  329.                     
  330. };
  331. typedef      IViewObject2 * LPVIEWOBJECT2, ** LPLPVIEWOBJECT2;
  332.  
  333.  
  334.  
  335. #undef  INTERFACE
  336. #define INTERFACE   IAdviseSink
  337.  
  338. DECLARE_INTERFACE_(IAdviseSink, IUnknown)
  339. { 
  340.     BEGIN_INTERFACE
  341.     // *** IUnknown methods ***
  342.     STDMETHOD(QueryInterface) (THIS_ REFIID riid, void * * ppv) PURE;
  343.     STDMETHOD_(unsigned long,AddRef) (THIS)  PURE;
  344.     STDMETHOD_(unsigned long,Release) (THIS) PURE;
  345.  
  346.     // *** IAdviseSink methods ***
  347.     STDMETHOD_(void,OnDataChange)(THIS_ FORMATETC * pFormatetc, 
  348.                             STGMEDIUM * pStgmed) PURE;
  349.     STDMETHOD_(void,OnViewChange)(THIS_ unsigned long dwAspect, long lindex) PURE;
  350.     STDMETHOD_(void,OnRename)(THIS_ LPMONIKER pmk) PURE;
  351.     STDMETHOD_(void,OnSave)(THIS) PURE;
  352.     STDMETHOD_(void,OnClose)(THIS) PURE;
  353. };
  354. //typedef      IAdviseSink * LPADVISESINK, ** LPLPADVISESINK;
  355.  
  356.  
  357.  
  358. #undef  INTERFACE
  359. #define INTERFACE   IAdviseSink2
  360.  
  361. DECLARE_INTERFACE_(IAdviseSink2, IAdviseSink)
  362. { 
  363.     BEGIN_INTERFACE
  364.     // *** IUnknown methods ***
  365.     STDMETHOD(QueryInterface) (THIS_ REFIID riid, void * * ppv) PURE;
  366.     STDMETHOD_(unsigned long,AddRef) (THIS)  PURE;
  367.     STDMETHOD_(unsigned long,Release) (THIS) PURE;
  368.  
  369.     // *** IAdviseSink methods ***
  370.     STDMETHOD_(void,OnDataChange)(THIS_ FORMATETC * pFormatetc, 
  371.                             STGMEDIUM * pStgmed) PURE;
  372.     STDMETHOD_(void,OnViewChange)(THIS_ unsigned long dwAspect, long lindex) PURE;
  373.     STDMETHOD_(void,OnRename)(THIS_ LPMONIKER pmk) PURE;
  374.     STDMETHOD_(void,OnSave)(THIS) PURE;
  375.     STDMETHOD_(void,OnClose)(THIS) PURE;
  376.  
  377.     // *** IAdviseSink2 methods ***
  378.     STDMETHOD_(void,OnLinkSrcChange)(THIS_ LPMONIKER pmk) PURE;
  379. };
  380. typedef      IAdviseSink2 * LPADVISESINK2, ** LPLPADVISESINK2;
  381.  
  382.  
  383.  
  384. #undef  INTERFACE
  385. #define INTERFACE   IDataAdviseHolder
  386.  
  387. DECLARE_INTERFACE_(IDataAdviseHolder, IUnknown)
  388. { 
  389.     BEGIN_INTERFACE
  390.     // *** IUnknown methods ***
  391.     STDMETHOD(QueryInterface) (THIS_ REFIID riid, void * * ppv) PURE;
  392.     STDMETHOD_(unsigned long,AddRef) (THIS)  PURE;
  393.     STDMETHOD_(unsigned long,Release) (THIS) PURE;
  394.  
  395.     // *** IDataAdviseHolder methods ***
  396.     STDMETHOD(Advise)(THIS_ LPDATAOBJECT pDataObject, FORMATETC * pFetc, 
  397.             unsigned long advf, LPADVISESINK pAdvise, unsigned long * pdwConnection) PURE;
  398.     STDMETHOD(Unadvise)(THIS_ unsigned long dwConnection) PURE;
  399.     STDMETHOD(EnumAdvise)(THIS_ LPLPENUMSTATDATA ppenumAdvise) PURE;
  400.  
  401.     STDMETHOD(SendOnDataChange)(THIS_ LPDATAOBJECT pDataObject, unsigned long dwReserved, unsigned long advf) PURE;
  402. };
  403. typedef      IDataAdviseHolder * LPDATAADVISEHOLDER, ** LPLPDATAADVISEHOLDER;
  404.  
  405.  
  406.  
  407. #undef  INTERFACE
  408. #define INTERFACE   IOleCache
  409.  
  410. #define CACHE_E_NOCACHE_UPDATED         (CACHE_E_FIRST)
  411.  
  412. #define CACHE_S_FORMATETC_NOTSUPPORTED  (CACHE_S_FIRST)
  413. #define CACHE_S_SAMECACHE               (CACHE_S_FIRST+1)
  414. #define CACHE_S_SOMECACHES_NOTUPDATED   (CACHE_S_FIRST+2)
  415.  
  416.  
  417. DECLARE_INTERFACE_(IOleCache, IUnknown)
  418. {
  419.     BEGIN_INTERFACE
  420.     // *** IUnknown methods ***
  421.     STDMETHOD(QueryInterface) (THIS_ REFIID riid, void * * ppvObj) PURE;
  422.     STDMETHOD_(unsigned long,AddRef) (THIS)  PURE;
  423.     STDMETHOD_(unsigned long,Release) (THIS) PURE;
  424.  
  425.     // *** IOleCache methods ***
  426.     STDMETHOD(Cache) (THIS_ LPFORMATETC lpFormatetc, unsigned long advf, unsigned long    * lpdwConnection) PURE;
  427.     STDMETHOD(Uncache) (THIS_ unsigned long dwConnection) PURE;
  428.     STDMETHOD(EnumCache) (THIS_ LPLPENUMSTATDATA ppenumStatData) PURE;
  429.     STDMETHOD(InitCache) (THIS_ LPDATAOBJECT pDataObject) PURE;
  430.     STDMETHOD(SetData) (THIS_ LPFORMATETC pformatetc, STGMEDIUM  * pmedium,
  431.                             unsigned long fRelease) PURE;
  432. };
  433. typedef         IOleCache * LPOLECACHE, ** LPLPOLECACHE;
  434.  
  435.  
  436.  
  437.  
  438. // Cache update Flags
  439.  
  440. #define    UPDFCACHE_NODATACACHE            0x00000001
  441. #define UPDFCACHE_ONSAVECACHE            0x00000002
  442. #define    UPDFCACHE_ONSTOPCACHE            0x00000004
  443. #define    UPDFCACHE_NORMALCACHE            0x00000008
  444. #define    UPDFCACHE_IFBLANK                0x00000010
  445. #define UPDFCACHE_ONLYIFBLANK            0x80000000
  446.  
  447. #define UPDFCACHE_IFBLANKORONSAVECACHE    (UPDFCACHE_IFBLANK | UPDFCACHE_ONSAVECACHE )
  448. #define UPDFCACHE_ALL                    (~UPDFCACHE_ONLYIFBLANK)
  449. #define UPDFCACHE_ALLBUTNODATACACHE        (UPDFCACHE_ALL & ~UPDFCACHE_NODATACACHE)
  450.  
  451.  
  452. // IOleCache2::DiscardCache options
  453. typedef enum tagDISCARDCACHE
  454. {
  455.     DISCARDCACHE_SAVEIFDIRTY =    0,    // Save all dirty cache before discarding
  456.     DISCARDCACHE_NOSAVE         =    1    // Don't save dirty caches before 
  457.                                     // discarding
  458.     ,DISCARDCACHE_FORCELONG    =    2147483647
  459. } DISCARDCACHE;
  460.  
  461.  
  462. #undef  INTERFACE
  463. #define INTERFACE   IOleCache2
  464.  
  465. DECLARE_INTERFACE_(IOleCache2, IOleCache)
  466. { 
  467.     BEGIN_INTERFACE
  468.     // *** IUnknown methods ***
  469.     STDMETHOD(QueryInterface) (THIS_ REFIID riid, void * * ppvObj) PURE;
  470.     STDMETHOD_(unsigned long,AddRef) (THIS)  PURE;
  471.     STDMETHOD_(unsigned long,Release) (THIS) PURE;
  472.  
  473.     // *** IOleCache methods ***
  474.     STDMETHOD(Cache) (THIS_ LPFORMATETC lpFormatetc, unsigned long advf, unsigned long    * lpdwConnection) PURE;
  475.     STDMETHOD(Uncache) (THIS_ unsigned long dwConnection) PURE;
  476.     STDMETHOD(EnumCache) (THIS_ LPLPENUMSTATDATA ppenumStatData) PURE;
  477.     STDMETHOD(InitCache) (THIS_ LPDATAOBJECT pDataObject) PURE;
  478.     STDMETHOD(SetData) (THIS_ LPFORMATETC pformatetc, STGMEDIUM  * pmedium,
  479.                             unsigned long fRelease) PURE;
  480.  
  481.     // *** IOleCache2 methods ***                            
  482.     STDMETHOD(UpdateCache) (THIS_ LPDATAOBJECT pDataObject, unsigned long grfUpdf, 
  483.                             void *pReserved) PURE;
  484.     STDMETHOD(DiscardCache) (THIS_ unsigned long dwDiscardOptions) PURE;
  485.                         
  486. };
  487. typedef      IOleCache2 * LPOLECACHE2, ** LPLPOLECACHE2;
  488.  
  489.  
  490. #undef  INTERFACE
  491. #define INTERFACE   IOleCacheControl
  492.  
  493. DECLARE_INTERFACE_(IOleCacheControl, IUnknown)
  494. { 
  495.     BEGIN_INTERFACE
  496.     // *** IUnknown methods ***
  497.     STDMETHOD(QueryInterface) (THIS_ REFIID riid, void * * ppvObj) PURE;
  498.     STDMETHOD_(unsigned long,AddRef) (THIS)  PURE;
  499.     STDMETHOD_(unsigned long,Release) (THIS) PURE;
  500.  
  501.     // *** IDataObject methods ***
  502.     STDMETHOD(OnRun) (THIS_ LPDATAOBJECT pDataObject) PURE;
  503.     STDMETHOD(OnStop) (THIS) PURE;
  504. };                 
  505. typedef      IOleCacheControl * LPOLECACHECONTROL, ** LPLPOLECACHECONTROL;
  506.  
  507.  
  508. /****** DV APIs ***********************************************************/
  509.  
  510.  
  511. STDAPI CreateDataAdviseHolder(LPLPDATAADVISEHOLDER ppDAHolder);
  512.  
  513. STDAPI CreateDataCache(LPUNKNOWN pUnkOuter, REFCLSID rclsid,
  514.                     REFIID iid, void ** ppv);
  515.                     
  516. #endif /* !__DVOBJ__ */
  517.